home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglgetmap.z / fglgetmap
Encoding:
Text File  |  2001-04-17  |  8.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllGGGGeeeettttMMMMaaaapppp((((3333GGGG))))                  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                  ffffggggllllGGGGeeeettttMMMMaaaapppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllGGGGeeeettttMMMMaaaappppddddvvvv,,,, ffffggggllllGGGGeeeettttMMMMaaaappppffffvvvv,,,, ffffggggllllGGGGeeeettttMMMMaaaappppiiiivvvv - return evaluator parameters
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllGGGGeeeettttMMMMaaaappppddddvvvv( INTEGER*4 _t_a_r_g_e_t,
  14.                              INTEGER*4 _q_u_e_r_y,
  15.                              CHARACTER*8 _v )
  16.      SUBROUTINE ffffggggllllGGGGeeeettttMMMMaaaappppffffvvvv( INTEGER*4 _t_a_r_g_e_t,
  17.                              INTEGER*4 _q_u_e_r_y,
  18.                              CHARACTER*8 _v )
  19.      SUBROUTINE ffffggggllllGGGGeeeettttMMMMaaaappppiiiivvvv( INTEGER*4 _t_a_r_g_e_t,
  20.                              INTEGER*4 _q_u_e_r_y,
  21.                              CHARACTER*8 _v )
  22.  
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _t_a_r_g_e_t  Specifies the symbolic name of a map.  Accepted values are
  26.              GGGGLLLL____MMMMAAAAPPPP1111____CCCCOOOOLLLLOOOORRRR____4444, GGGGLLLL____MMMMAAAAPPPP1111____IIIINNNNDDDDEEEEXXXX, GGGGLLLL____MMMMAAAAPPPP1111____NNNNOOOORRRRMMMMAAAALLLL,
  27.              GGGGLLLL____MMMMAAAAPPPP1111____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____1111, GGGGLLLL____MMMMAAAAPPPP1111____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____2222,
  28.              GGGGLLLL____MMMMAAAAPPPP1111____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____3333, GGGGLLLL____MMMMAAAAPPPP1111____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____4444,
  29.              GGGGLLLL____MMMMAAAAPPPP1111____VVVVEEEERRRRTTTTEEEEXXXX____3333, GGGGLLLL____MMMMAAAAPPPP1111____VVVVEEEERRRRTTTTEEEEXXXX____4444, GGGGLLLL____MMMMAAAAPPPP2222____CCCCOOOOLLLLOOOORRRR____4444,
  30.              GGGGLLLL____MMMMAAAAPPPP2222____IIIINNNNDDDDEEEEXXXX, GGGGLLLL____MMMMAAAAPPPP2222____NNNNOOOORRRRMMMMAAAALLLL, GGGGLLLL____MMMMAAAAPPPP2222____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____1111,
  31.              GGGGLLLL____MMMMAAAAPPPP2222____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____2222, GGGGLLLL____MMMMAAAAPPPP2222____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____3333,
  32.              GGGGLLLL____MMMMAAAAPPPP2222____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____4444, GGGGLLLL____MMMMAAAAPPPP2222____VVVVEEEERRRRTTTTEEEEXXXX____3333, and GGGGLLLL____MMMMAAAAPPPP2222____VVVVEEEERRRRTTTTEEEEXXXX____4444.
  33.  
  34.      _q_u_e_r_y   Specifies which parameter to return.  Symbolic names GGGGLLLL____CCCCOOOOEEEEFFFFFFFF,
  35.              GGGGLLLL____OOOORRRRDDDDEEEERRRR, and GGGGLLLL____DDDDOOOOMMMMAAAAIIIINNNN are accepted.
  36.  
  37.      _v       Returns the requested data.
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      ffffggggllllMMMMaaaapppp1111 and ffffggggllllMMMMaaaapppp2222 define evaluators.  ffffggggllllGGGGeeeettttMMMMaaaapppp returns evaluator
  41.      parameters.  _t_a_r_g_e_t chooses a map, _q_u_e_r_y selects a specific parameter,
  42.      and _v points to storage where the values will be returned.
  43.  
  44.      The acceptable values for the _t_a_r_g_e_t parameter are described in the
  45.      ffffggggllllMMMMaaaapppp1111 and ffffggggllllMMMMaaaapppp2222 reference pages.
  46.  
  47.      _q_u_e_r_y can assume the following values:
  48.  
  49.      GGGGLLLL____CCCCOOOOEEEEFFFFFFFF       _v returns the control points for the evaluator function.
  50.                     One-dimensional evaluators return order control points,
  51.                     and two-dimensional evaluators return uorder x vorder
  52.                     control points.  Each control point consists of one, two,
  53.                     three, or four integer, single-precision floating-point,
  54.                     or double-precision floating-point values, depending on
  55.                     the type of the evaluator.  The GL returns two-dimensional
  56.                     control points in row-major order, incrementing the uorder
  57.                     index quickly and the vorder index after each row.
  58.                     Integer values, when requested, are computed by rounding
  59.                     the internal floating-point values to the nearest integer
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllGGGGeeeettttMMMMaaaapppp((((3333GGGG))))                  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                  ffffggggllllGGGGeeeettttMMMMaaaapppp((((3333GGGG))))
  71.  
  72.  
  73.  
  74.                     values.
  75.  
  76.      GGGGLLLL____OOOORRRRDDDDEEEERRRR       _v returns the order of the evaluator function.  One-
  77.                     dimensional evaluators return a single value, order. The
  78.                     initial value is 1.  Two-dimensional evaluators return two
  79.                     values, uorder and vorder. The initial value is 1,1.
  80.  
  81.      GGGGLLLL____DDDDOOOOMMMMAAAAIIIINNNN      _v returns the linear u and v mapping parameters.  One-
  82.                     dimensional evaluators return two values, u1 and u2, as
  83.                     specified by ffffggggllllMMMMaaaapppp1111.  Two-dimensional evaluators return
  84.                     four values (u1, u2, v1, and v2) as specified by ffffggggllllMMMMaaaapppp2222.
  85.                     Integer values, when requested, are computed by rounding
  86.                     the internal floating-point values to the nearest integer
  87.                     values.
  88.  
  89. NNNNOOOOTTTTEEEESSSS
  90.      If an error is generated, no change is made to the contents of _v.
  91.  
  92. EEEERRRRRRRROOOORRRRSSSS
  93.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if either _t_a_r_g_e_t or _q_u_e_r_y is not an accepted
  94.      value.
  95.  
  96.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllGGGGeeeettttMMMMaaaapppp is executed between the
  97.      execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd.
  98.  
  99.  
  100. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  101.      ffffggggllllEEEEvvvvaaaallllCCCCoooooooorrrrdddd, ffffggggllllMMMMaaaapppp1111, ffffggggllllMMMMaaaapppp2222
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.